summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLibravatar tobi <tobi.smethurst@protonmail.com>2025-05-06 14:28:40 +0000
committerLibravatar tobi <kipvandenbos@noreply.codeberg.org>2025-05-06 14:28:40 +0000
commit7d74548a91b792d1cf0e8bf039dc5ed2151961ac (patch)
tree66b393dc79ea90682a5f006640ccca92575a4f62
parent[bugfix] fix statuses not being notified (#4143) (diff)
downloadgotosocial-7d74548a91b792d1cf0e8bf039dc5ed2151961ac.tar.xz
[docs] Various little docs updates (#4144)
Just various little docs fixes, including adding registry prefix `docker.io/` to Docker container tags. Closes https://codeberg.org/superseriousbusiness/gotosocial/issues/4126 Reviewed-on: https://codeberg.org/superseriousbusiness/gotosocial/pulls/4144 Co-authored-by: tobi <tobi.smethurst@protonmail.com> Co-committed-by: tobi <tobi.smethurst@protonmail.com>
-rw-r--r--.goreleaser.yml24
-rw-r--r--README.md6
-rw-r--r--docs/locales/zh/repo/README.md4
-rw-r--r--example/docker-compose/docker-compose.yaml2
4 files changed, 18 insertions, 18 deletions
diff --git a/.goreleaser.yml b/.goreleaser.yml
index 52ad9e06f..6b3d79f38 100644
--- a/.goreleaser.yml
+++ b/.goreleaser.yml
@@ -263,8 +263,8 @@ release:
#### Binary/tar
1. Stop GoToSocial.
- 2. **Back up your database!** If you're running on SQLite, this is as simple as copying your `sqlite.db` file, eg., `cp sqlite.db sqlite.db.backup`.
- 3. Download and untar the new release, including the web assets and html templates.
+ 2. **Back up your database!** If you're running on SQLite, this is as simple as copying your `sqlite.db` file, eg., `cp sqlite.db sqlite.db.backup`. On Postgres you can do this with [pg_dump](https://www.postgresql.org/docs/current/backup-dump.html).
+ 3. Download and untar the new release, **including the web assets and html templates**, not just the binary.
4. Edit your config.yaml file if necessary (see below).
5. Start GoToSocial.
6. Wait patiently for any migrations to run, **do not interrupt migrations or you could leave your db in a broken state and will have to restore from backup**!
@@ -273,8 +273,8 @@ release:
#### Docker
1. Stop GoToSocial.
- 2. **Back up your database!** If you're running on SQLite, this is as simple as copying your `sqlite.db` file, eg., `cp sqlite.db sqlite.db.backup`.
- 3. Pull the new docker container (`superseriousbusiness/gotosocial:{{ .Version }}` or `superseriousbusiness/gotosocial:latest`)
+ 2. **Back up your database!** If you're running on SQLite, this is as simple as copying your `sqlite.db` file, eg., `cp sqlite.db sqlite.db.backup`. On Postgres you can do this with [pg_dump](https://www.postgresql.org/docs/current/backup-dump.html).
+ 3. Pull the new docker container with `docker pull docker.io/superseriousbusiness/gotosocial:{{ .Version }}` or `docker pull docker.io/superseriousbusiness/gotosocial:latest` if this is a stable release and not a release candidate.
4. Edit your config.yaml file or environment variables if necessary (see below).
5. Start GoToSocial.
6. Wait patiently for any migrations to run, **do not interrupt migrations or you could leave your db in a broken state and will have to restore from backup**!
@@ -307,14 +307,14 @@ release:
GoToSocial releases binary builds for 64-bit Linux, FreeBSD, and NetBSD operating systems. We also release Docker builds for 64-bit Linux.
- | OS | Architecture | Support level | Binary archive | Docker |
- | ------- | ----------------------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
- | Linux | x86-64/AMD64 (64-bit) | 🟢 Full | [linux_amd64.tar.gz](https://codeberg.org/superseriousbusiness/gotosocial/releases/download/{{ .Tag }}/gotosocial_{{ .Version }}_linux_amd64.tar.gz) | `superseriousbusiness/gotosocial:{{ .Version }}` |
- | Linux | Armv8/ARM64 (64-bit) | 🟢 Full | [linux_arm64.tar.gz](https://codeberg.org/superseriousbusiness/gotosocial/releases/download/{{ .Tag }}/gotosocial_{{ .Version }}_linux_arm64.tar.gz) | `superseriousbusiness/gotosocial:{{ .Version }}` |
- | FreeBSD | x86-64/AMD64 (64-bit) | 🟢 Full | [freebsd_amd64.tar.gz](https://codeberg.org/superseriousbusiness/gotosocial/releases/download/{{ .Tag }}/gotosocial_{{ .Version }}_freebsd_amd64.tar.gz) | Not provided |
- | FreeBSD | Armv8/ARM64 (64-bit) | 🟢 Full | [freebsd_arm64.tar.gz](https://codeberg.org/superseriousbusiness/gotosocial/releases/download/{{ .Tag }}/gotosocial_{{ .Version }}_freebsd_arm64.tar.gz) | Not provided |
- | NetBSD | x86-64/AMD64 (64-bit) | 🟢 Full | [netbsd_amd64.tar.gz](https://codeberg.org/superseriousbusiness/gotosocial/releases/download/{{ .Tag }}/gotosocial_{{ .Version }}_netbsd_amd64.tar.gz) | Not provided |
- | NetBSD | Armv8/ARM64 (64-bit) | 🟢 Full | [netbsd_arm64.tar.gz](https://codeberg.org/superseriousbusiness/gotosocial/releases/download/{{ .Tag }}/gotosocial_{{ .Version }}_netbsd_arm64.tar.gz) | Not provided |
+ | OS | Architecture | Support level | Binary archive | Docker |
+ | ------- | ----------------------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
+ | Linux | x86-64/AMD64 (64-bit) | 🟢 Full | [linux_amd64.tar.gz](https://codeberg.org/superseriousbusiness/gotosocial/releases/download/{{ .Tag }}/gotosocial_{{ .Version }}_linux_amd64.tar.gz) | `docker.io/superseriousbusiness/gotosocial:{{ .Version }}` |
+ | Linux | Armv8/ARM64 (64-bit) | 🟢 Full | [linux_arm64.tar.gz](https://codeberg.org/superseriousbusiness/gotosocial/releases/download/{{ .Tag }}/gotosocial_{{ .Version }}_linux_arm64.tar.gz) | `docker.io/superseriousbusiness/gotosocial:{{ .Version }}` |
+ | FreeBSD | x86-64/AMD64 (64-bit) | 🟢 Full | [freebsd_amd64.tar.gz](https://codeberg.org/superseriousbusiness/gotosocial/releases/download/{{ .Tag }}/gotosocial_{{ .Version }}_freebsd_amd64.tar.gz) | Not provided |
+ | FreeBSD | Armv8/ARM64 (64-bit) | 🟢 Full | [freebsd_arm64.tar.gz](https://codeberg.org/superseriousbusiness/gotosocial/releases/download/{{ .Tag }}/gotosocial_{{ .Version }}_freebsd_arm64.tar.gz) | Not provided |
+ | NetBSD | x86-64/AMD64 (64-bit) | 🟢 Full | [netbsd_amd64.tar.gz](https://codeberg.org/superseriousbusiness/gotosocial/releases/download/{{ .Tag }}/gotosocial_{{ .Version }}_netbsd_amd64.tar.gz) | Not provided |
+ | NetBSD | Armv8/ARM64 (64-bit) | 🟢 Full | [netbsd_arm64.tar.gz](https://codeberg.org/superseriousbusiness/gotosocial/releases/download/{{ .Tag }}/gotosocial_{{ .Version }}_netbsd_arm64.tar.gz) | Not provided |
#### `nowasm`
diff --git a/README.md b/README.md
index e3d906dd1..a580b1692 100644
--- a/README.md
+++ b/README.md
@@ -262,7 +262,7 @@ On top of this API, web developers are encouraged to build any front-end impleme
Don't like GtS but still want to use the fediverse? Like GtS but prefer not to use beta software? There are lots of alternatives that might suit you better! Here are some that we know work well (alphabetical order):
-- [Akkoma]([https://](https://akkoma.social/)): Full-featured ActivityPub microblogging with emoji reacts and quote posts (Elixir).
+- [Akkoma](https://akkoma.social/): Full-featured ActivityPub microblogging with emoji reacts and quote posts (Elixir).
- [Honk](https://humungus.tedunangst.com/r/honk/m/activitypub.7): Minimalist, opinionated microblogging with "No likes, no faves, no polls, no stars, no claps, no counts." (Go).
- [Iceshrimp.net](https://iceshrimp.dev/iceshrimp/Iceshrimp.NET): rewrite of Iceshrimp from the ground up (.Net).
- [Mastodon](https://joinmastodon.org/): Actively developed, widely recognized, scaleable ActivityPub microblogging instance (Ruby).
@@ -336,7 +336,7 @@ While we don't support running GtS on OpenBSD, you may have some success buildin
We package our stable releases for both binary builds and Docker containers, so that you don't have to build from source yourself.
-The Docker image `superseriousbusiness/gotosocial:latest` will always correspond to the latest stable release. Since this tag is overwritten frequently, you may want to use Docker CLI flag `--pull always` to ensure that you always have the most up-to-date image every time you run using this tag. Alternatively, run `docker pull superseriousbusiness/gotosocial:latest` manually just before use.
+The Docker image `docker.io/superseriousbusiness/gotosocial:latest` will always correspond to the latest stable release. Since this tag is overwritten frequently, you may want to use Docker CLI flag `--pull always` to ensure that you always have the most up-to-date image every time you run using this tag. Alternatively, run `docker pull docker.io/superseriousbusiness/gotosocial:latest` manually just before use.
### Snapshot Releases
@@ -346,7 +346,7 @@ Please be warned that you do so at your own risk! We try to keep main working pr
#### Docker
-To run from main using Docker, use the `snapshot` Docker tag. The Docker image `superseriousbusiness/gotosocial:snapshot` will always correspond to the latest commit on main. Since this tag is overwritten frequently, you may want to use Docker CLI flag `--pull always` to ensure that you always have the most up-to-date image every time you run using this tag. Alternatively, run `docker pull superseriousbusiness/gotosocial:snapshot` manually just before use.
+To run from main using Docker, use the `snapshot` Docker tag. The Docker image `docker.io/superseriousbusiness/gotosocial:snapshot` will always correspond to the latest commit on main that involves changes to Go code or web assets/source. Since this tag is overwritten frequently, you may want to use Docker CLI flag `--pull always` to ensure that you always have the most up-to-date image every time you run using this tag. Alternatively, run `docker pull docker.io/superseriousbusiness/gotosocial:snapshot` manually just before use.
#### Binary release .tar.gz
diff --git a/docs/locales/zh/repo/README.md b/docs/locales/zh/repo/README.md
index 66879491a..66e562ade 100644
--- a/docs/locales/zh/repo/README.md
+++ b/docs/locales/zh/repo/README.md
@@ -338,7 +338,7 @@ GtS åœ¨åƒ i386 或 Armv6/v7 这样的 32 ä½ç³»ç»Ÿä¸Šè¡¨çްä¸ä½³ï¼Œè¿™ä¸»è¦æ˜
我们为二进制构建和 Docker 容器打包稳定版本,这样你就ä¸éœ€è¦è‡ªå·±ä»Žæºä»£ç æž„建。
-Docker é•œåƒ `superseriousbusiness/gotosocial:latest` 始终对应于最新稳定版本。由于此标签ç»å¸¸è¢«è¦†ç›–,你å¯èƒ½å¸Œæœ›ä½¿ç”¨ Docker CLI 标志 `--pull always` ç¡®ä¿æ¯æ¬¡è¿è¡Œæ­¤æ ‡ç­¾æ—¶éƒ½æœ‰æœ€æ–°çš„镜åƒï¼Œæˆ–者也å¯åœ¨ä½¿ç”¨å‰æ‰‹åЍè¿è¡Œ `docker pull superseriousbusiness/gotosocial:latest`。
+Docker é•œåƒ `docker.io/superseriousbusiness/gotosocial:latest` 始终对应于最新稳定版本。由于此标签ç»å¸¸è¢«è¦†ç›–,你å¯èƒ½å¸Œæœ›ä½¿ç”¨ Docker CLI 标志 `--pull always` ç¡®ä¿æ¯æ¬¡è¿è¡Œæ­¤æ ‡ç­¾æ—¶éƒ½æœ‰æœ€æ–°çš„镜åƒï¼Œæˆ–者也å¯åœ¨ä½¿ç”¨å‰æ‰‹åЍè¿è¡Œ `docker pull docker.io/superseriousbusiness/gotosocial:latest`。
### 快照版本
@@ -348,7 +348,7 @@ Docker é•œåƒ `superseriousbusiness/gotosocial:latest` 始终对应于最新稳å
#### Docker
-è¦ä½¿ç”¨ Docker 从主分支è¿è¡Œï¼Œè¯·ä½¿ç”¨ `snapshot` Docker 标签。Docker é•œåƒ `superseriousbusiness/gotosocial:snapshot` 始终对应主分支上的最新æäº¤ã€‚由于此标签ç»å¸¸è¢«è¦†ç›–,你å¯èƒ½å¸Œæœ›ä½¿ç”¨ Docker CLI 标志 `--pull always` ç¡®ä¿æ¯æ¬¡è¿è¡Œæ­¤æ ‡ç­¾æ—¶éƒ½æœ‰æœ€æ–°çš„镜åƒï¼Œæˆ–者也å¯åœ¨ä½¿ç”¨å‰æ‰‹åЍè¿è¡Œ `docker pull superseriousbusiness/gotosocial:snapshot`。
+è¦ä½¿ç”¨ Docker 从主分支è¿è¡Œï¼Œè¯·ä½¿ç”¨ `snapshot` Docker 标签。Docker é•œåƒ `docker.io/superseriousbusiness/gotosocial:snapshot` 始终对应主分支上的最新æäº¤ã€‚由于此标签ç»å¸¸è¢«è¦†ç›–,你å¯èƒ½å¸Œæœ›ä½¿ç”¨ Docker CLI 标志 `--pull always` ç¡®ä¿æ¯æ¬¡è¿è¡Œæ­¤æ ‡ç­¾æ—¶éƒ½æœ‰æœ€æ–°çš„镜åƒï¼Œæˆ–者也å¯åœ¨ä½¿ç”¨å‰æ‰‹åЍè¿è¡Œ `docker pull docker.io/superseriousbusiness/gotosocial:snapshot`。
#### 二进制å‘布 .tar.gz
diff --git a/example/docker-compose/docker-compose.yaml b/example/docker-compose/docker-compose.yaml
index fbd9af8dd..eeb1bc056 100644
--- a/example/docker-compose/docker-compose.yaml
+++ b/example/docker-compose/docker-compose.yaml
@@ -1,6 +1,6 @@
services:
gotosocial:
- image: superseriousbusiness/gotosocial:latest
+ image: docker.io/superseriousbusiness/gotosocial:latest
container_name: gotosocial
user: 1000:1000
networks: