--- /dev/null
++++
+categories = ["Releases"]
+tags = ["Releases"]
+title = "Beta Release v0.25.1"
+date = 2019-01-20T16:30:00Z
+author = "Dan Brown"
+image = "/images/blog-cover-images/winter-annie-spratt.jpg"
+description = "v0.25.1 patches some bugs in addition to bringing support for s3 compatible services"
+slug = "beta-release-v0-25-1"
+draft = false
++++
+
+Soon after the v0.25 release last weekend we have the v0.25.1 patch release to fix some bugs, add support for s3 compatible services and to prepare for the upcoming
+removal of the Google Plus API.
+
+* [Update instructions](https://www.bookstackapp.com/docs/admin/updates)
+* [GitHub release page](https://github.com/BookStackApp/BookStack/releases/tag/v0.25.1)
+
+
+### Google Sign-in Changes
+
+Google [have announced](https://developers.google.com/+/api-shutdown) the shut-down of Google+ API's which is what BookStack was using for it's Google authentication option.
+The API's are due to be shut down on March the 7th, With API failures starting from January the 28th.
+
+In this release the API calls made no longer make use of the Google+ API so all you'll need to do is to update your BookStack instance to continue using the Google sign-in option. You should be able to continue using the same OAuth credentials as before.
+
+### S3 Compatible Service Support
+
+This release introduces some configuration changes that make it possible to use BookStack with s3 compatible services such as Minio or Ceph (With a s3-compatible gateway).
+Details of this can be found [in the docs here](/docs/admin/upload-config/#non-amazon-s3-compatible-services).
+
+### Full List of Changes
+
+* Updated revision listing so dates can show localised if the relevant locale is installed on the host system. ([#1214](https://github.com/BookStackApp/BookStack/issues/1214))
+* Added support for s3 compatible storage services such as Minio. ([#1195](https://github.com/BookStackApp/BookStack/issues/1195), [#1192](https://github.com/BookStackApp/BookStack/issues/1192))
+* Updated Google authentication to not use Google+ API. ([#1190](https://github.com/BookStackApp/BookStack/issues/1190))
+* Fixed "Rubber banding" effect when scrolling in certain conditions when comments were disabled. ([#1218](https://github.com/BookStackApp/BookStack/issues/1218))
+* Fixed isssue causing only show a single page to show when using Firefox's print option. ([#1211](https://github.com/BookStackApp/BookStack/issues/1211))
+
+
+----
+
+<span style="font-size: 0.8em;opacity:0.8;">Header Image Credits: <a style="background-color:black;color:white;text-decoration:none;padding:4px 6px;font-family:-apple-system, BlinkMacSystemFont, "San Francisco", "Helvetica Neue", Helvetica, Ubuntu, Roboto, Noto, "Segoe UI", Arial, sans-serif;font-size:12px;font-weight:bold;line-height:1.2;display:inline-block;border-radius:3px" href="https://unsplash.com/@anniespratt?utm_medium=referral&utm_campaign=photographer-credit&utm_content=creditBadge" target="_blank" rel="noopener noreferrer" title="Download free do whatever you want high-resolution photos from Annie Spratt"><span style="display:inline-block;padding:2px 3px"><svg xmlns="http://www.w3.org/2000/svg" style="height:12px;width:auto;position:relative;vertical-align:middle;top:-2px;fill:white" viewBox="0 0 32 32"><title>unsplash-logo</title><path d="M10 9V0h12v9H10zm12 5h10v18H0V14h10v9h12v-9z"></path></svg></span><span style="display:inline-block;padding:2px 3px">Annie Spratt</span></a></span>
```bash
APP_AUTO_LANG_PUBLIC=false
```
+
+### Localised Date Formatting
+
+BookStack does support the localisation of date formats but it does depend on the intended locales being installed
+on the host system. If using ubuntu, you can manage installed locales via the command:
+
+```bash
+sudo dpkg-reconfigure locales
+```
+
+For other operating systems this may be different. After installing new locales you may need to restart any running PHP processes.
+For example, On Ubuntu, running PHP7.2:
+
+```bash
+sudo systemctl restart php7.2-fpm.service
+```
\ No newline at end of file
1. Open the [Google Developers Console](https://console.developers.google.com/).
2. Create a new project (May have to wait a short while for it to be created).
-3. Select 'Enable and manage APIs'.
-4. Enable the 'Google+ API'.
-5. In 'Credentials' choose the 'OAuth consent screen' tab and enter a product name ('BookStack' or your custom set name).
-6. Back in the 'Credentials' tab click 'New credentials' > 'OAuth client ID'.
-7. Choose an application type of 'Web application' and enter the following urls under 'Authorized redirect URIs', changing `https://example.com` to your own domain where BookStack is hosted:
+3. In 'Credentials' choose the 'OAuth consent screen' tab and enter a product name ('BookStack' or your custom set name).
+4. Back in the 'Credentials' tab click 'New credentials' > 'OAuth client ID'.
+5. Choose an application type of 'Web application' and enter the following urls under 'Authorized redirect URIs', changing `https://example.com` to your own domain where BookStack is hosted:
- `https://example.com/login/service/google/callback`
- `https://example.com/register/service/google/callback`
-8. Add or set the following items in your `.env` file like so:
+6. Add or set the following items in your `.env` file like so:
```bash
# Replace the below (including '{}' braces) with your Google API_KEY and API_SECRET
GOOGLE_APP_ID={google_app_id}
# APP_URL Needs to be set to your BookStack base url
APP_URL=http://mybookstackurl.com
```
-10. All done! Users should now be able to link their social accounts in their account profile pages and also register/login using their Google accounts.
+7. All done! Users should now be able to link their social accounts in their account profile pages and also register/login using their Google accounts.
---
STORAGE_URL=https://images.example.com
```
+#### Non-Amazon, S3 Compatible Services
+
+Via the s3 connection BookStack does support s3-compatible services such as [Minio](https://www.minio.io/). Read the above S3 details to get an idea of general setup.
+For non-Amazon services the configuration, to be placed in the `.env` file, is a little different:
+
+```bash
+STORAGE_TYPE=s3
+STORAGE_S3_KEY=your-service-key
+STORAGE_S3_SECRET=your-service-secret-key
+STORAGE_S3_BUCKET=your-service-bucket-name
+
+STORAGE_S3_ENDPOINT=https://your-service-base-endpoint.com:8080
+STORAGE_URL=https://your-service-base-endpoint.com:8080/your-service-bucket-name
+```
+
+Take note of how the first part of the `STORAGE_URL` path is the bucket name. This is important to ensure image URLs are set correctly.
+
+BookStack's functionality to set image URL's as publicly accessible will likely not work for third-party services so you'll need to ensure files under the `<your_bucket>/uploads/images` path have policy or permissions to be publicly accessible. If using Minio you can add the following to the bucket policy:
+
+
+
---
### Changing Upload Limits
--- /dev/null
+version https://git-lfs.github.com/spec/v1
+oid sha256:d6fe1452c51fdde54b3f788d267f7506159706b319d1e10d8809e1477d75793b
+size 10101
--- /dev/null
+version https://git-lfs.github.com/spec/v1
+oid sha256:b2c81eece02e087ea8721b30b0de38c0c12b2aaf7af98f79fae1f37f15c44230
+size 426219
projects / website / commitdiff