projects
/
akkoma
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
Update install docs (#38)
[akkoma]
/
docs
/
installation
/
debian_based_jp.md
diff --git
a/docs/installation/debian_based_jp.md
b/docs/installation/debian_based_jp.md
index 42e91cda7f29486ecc2b160d46eff70d2154995f..5d38f43cf525b4e6638e266dc3e5ae1b24a4a971 100644
(file)
--- a/
docs/installation/debian_based_jp.md
+++ b/
docs/installation/debian_based_jp.md
@@
-1,26
+1,31
@@
-#
Pler
omaの入れ方
+#
Akk
omaの入れ方
## 日本語訳について
この記事は [Installing on Debian based distributions](Installing on Debian based distributions) の日本語訳です。何かがおかしいと思ったら、原文を見てください。
## インストール
## 日本語訳について
この記事は [Installing on Debian based distributions](Installing on Debian based distributions) の日本語訳です。何かがおかしいと思ったら、原文を見てください。
## インストール
-このガイドはDebian Stretchを利用することを想定しています。Ubuntu 16.04や18.04でもおそらく動作します。また、ユーザはrootもしくはsudoにより管理者権限を持っていることを前提とします。もし、以下の操作をrootユーザで行う場合は、 `sudo` を無視してください。ただし、`sudo -Hu
pler
oma` のようにユーザを指定している場合には `su <username> -s $SHELL -c 'command'` を代わりに使ってください。
+このガイドはDebian Stretchを利用することを想定しています。Ubuntu 16.04や18.04でもおそらく動作します。また、ユーザはrootもしくはsudoにより管理者権限を持っていることを前提とします。もし、以下の操作をrootユーザで行う場合は、 `sudo` を無視してください。ただし、`sudo -Hu
akk
oma` のようにユーザを指定している場合には `su <username> -s $SHELL -c 'command'` を代わりに使ってください。
### 必要なソフトウェア
- PostgreSQL 9.6以上 (Ubuntu16.04では9.5しか提供されていないので,[](https://www.postgresql.org/download/linux/ubuntu/)こちらから新しいバージョンを入手してください)
- `postgresql-contrib` 9.6以上 (同上)
### 必要なソフトウェア
- PostgreSQL 9.6以上 (Ubuntu16.04では9.5しか提供されていないので,[](https://www.postgresql.org/download/linux/ubuntu/)こちらから新しいバージョンを入手してください)
- `postgresql-contrib` 9.6以上 (同上)
-- Elixir 1.8 以上 ([Debianのリポジトリからインストールしないこと!!! ここからインストールすること!](https://elixir-lang.org/install.html#unix-and-unix-like)。または [asdf](https://github.com/asdf-vm/asdf) を
pler
omaユーザーでインストールしてください)
+- Elixir 1.8 以上 ([Debianのリポジトリからインストールしないこと!!! ここからインストールすること!](https://elixir-lang.org/install.html#unix-and-unix-like)。または [asdf](https://github.com/asdf-vm/asdf) を
akk
omaユーザーでインストールしてください)
- `erlang-dev`
- `erlang-nox`
- `git`
- `build-essential`
- `erlang-dev`
- `erlang-nox`
- `git`
- `build-essential`
+- `cmake`
+- `libmagic-dev`
#### このガイドで利用している追加パッケージ
- `nginx` (おすすめです。他のリバースプロキシを使う場合は、参考となる設定をこのリポジトリから探してください)
- `certbot` (または何らかのLet's Encrypt向けACMEクライアント)
#### このガイドで利用している追加パッケージ
- `nginx` (おすすめです。他のリバースプロキシを使う場合は、参考となる設定をこのリポジトリから探してください)
- `certbot` (または何らかのLet's Encrypt向けACMEクライアント)
+- `ImageMagick`
+- `ffmpeg`
+- `exiftool`
### システムを準備する
### システムを準備する
@@
-32,10
+37,9
@@
sudo apt full-upgrade
* 上記に挙げたパッケージをインストールしておきます。
```
* 上記に挙げたパッケージをインストールしておきます。
```
-sudo apt install git build-essential postgresql postgresql-contrib
+sudo apt install git build-essential postgresql postgresql-contrib
cmake ffmpeg imagemagick libmagic-dev
```
```
-
### ElixirとErlangをインストールします
* Erlangのリポジトリをダウンロードおよびインストールします。
### ElixirとErlangをインストールします
* Erlangのリポジトリをダウンロードおよびインストールします。
@@
-50,65
+54,71
@@
sudo apt update
sudo apt install elixir erlang-dev erlang-nox
```
sudo apt install elixir erlang-dev erlang-nox
```
-### Pleroma BE (バックエンド) をインストールします
+### オプションパッケージ: [`docs/installation/optional/media_graphics_packages.md`](../installation/optional/media_graphics_packages.md)
+
+```shell
+sudo apt install imagemagick ffmpeg libimage-exiftool-perl
+```
+
+### Akkoma BE (バックエンド) をインストールします
-*
Pler
oma用に新しいユーザーを作ります。
+*
Akk
oma用に新しいユーザーを作ります。
```
```
-sudo useradd -r -s /bin/false -m -d /var/lib/
pleroma -U pler
oma
+sudo useradd -r -s /bin/false -m -d /var/lib/
akkoma -U akk
oma
```
```
-**注意**:
Pleromaユーザとして単発のコマンドを実行したい場合はは、`sudo -Hu pleroma command` を使ってください。シェルを使いたい場合は `sudo -Hu pleroma $SHELL`です。もし `sudo` を使わない場合は、rootユーザで `su -l pleroma -s $SHELL -c 'command'` とすることでコマンドを、`su -l pler
oma -s $SHELL` とすることでシェルを開始できます。
+**注意**:
Akkomaユーザとして単発のコマンドを実行したい場合はは、`sudo -Hu akkoma command` を使ってください。シェルを使いたい場合は `sudo -Hu akkoma $SHELL`です。もし `sudo` を使わない場合は、rootユーザで `su -l akkoma -s $SHELL -c 'command'` とすることでコマンドを、`su -l akk
oma -s $SHELL` とすることでシェルを開始できます。
* Gitリポジトリをクローンします。
```
* Gitリポジトリをクローンします。
```
-sudo mkdir -p /opt/
pler
oma
-sudo chown -R
pleroma:pleroma /opt/pler
oma
-sudo -Hu
pleroma git clone -b stable https://git.pleroma.social/pleroma/pleroma /opt/pler
oma
+sudo mkdir -p /opt/
akk
oma
+sudo chown -R
akkoma:akkoma /opt/akk
oma
+sudo -Hu
akkoma git clone https://akkoma.dev/AkkomaGang/akkoma.git /opt/akk
oma
```
* 新しいディレクトリに移動します。
```
```
* 新しいディレクトリに移動します。
```
-cd /opt/
pler
oma
+cd /opt/
akk
oma
```
```
-*
Pler
omaが依存するパッケージをインストールします。Hexをインストールしてもよいか聞かれたら、yesを入力してください。
+*
Akk
omaが依存するパッケージをインストールします。Hexをインストールしてもよいか聞かれたら、yesを入力してください。
```
```
-sudo -Hu
pler
oma mix deps.get
+sudo -Hu
akk
oma mix deps.get
```
* コンフィギュレーションを生成します。
```
```
* コンフィギュレーションを生成します。
```
-sudo -Hu
pleroma
mix pleroma.instance gen
+sudo -Hu
akkoma MIX_ENV=prod
mix pleroma.instance gen
```
* rebar3をインストールしてもよいか聞かれたら、yesを入力してください。
```
* rebar3をインストールしてもよいか聞かれたら、yesを入力してください。
- * このときに
pler
omaの一部がコンパイルされるため、この処理には時間がかかります。
+ * このときに
akk
omaの一部がコンパイルされるため、この処理には時間がかかります。
* あなたのインスタンスについて、いくつかの質問されます。この質問により `config/generated_config.exs` という設定ファイルが生成されます。
* コンフィギュレーションを確認して、もし問題なければ、ファイル名を変更してください。
```
* あなたのインスタンスについて、いくつかの質問されます。この質問により `config/generated_config.exs` という設定ファイルが生成されます。
* コンフィギュレーションを確認して、もし問題なければ、ファイル名を変更してください。
```
-mv config/{generated_config.exs,prod.secret.exs}
+
sudo -Hu akkoma
mv config/{generated_config.exs,prod.secret.exs}
```
* 先程のコマンドで、すでに `config/setup_db.psql` というファイルが作られています。このファイルをもとに、データベースを作成します。
```
```
* 先程のコマンドで、すでに `config/setup_db.psql` というファイルが作られています。このファイルをもとに、データベースを作成します。
```
-sudo -Hu
pleroma
mix pleroma.instance gen
+sudo -Hu
akkoma MIX_ENV=prod
mix pleroma.instance gen
```
* そして、データベースのマイグレーションを実行します。
```
```
* そして、データベースのマイグレーションを実行します。
```
-sudo -Hu
pler
oma MIX_ENV=prod mix ecto.migrate
+sudo -Hu
akk
oma MIX_ENV=prod mix ecto.migrate
```
```
-* これで
Pler
omaを起動できるようになりました。
+* これで
Akk
omaを起動できるようになりました。
```
```
-sudo -Hu
pler
oma MIX_ENV=prod mix phx.server
+sudo -Hu
akk
oma MIX_ENV=prod mix phx.server
```
### インストールの最終段階
```
### インストールの最終段階
-あなたの新しいインスタンスを世界に向けて公開するには、nginx等のWebサーバやプロキシサーバを
Pleromaの前段に使用する必要があります。また、Pler
oma のためにシステムサービスファイルを作成する必要があります。
+あなたの新しいインスタンスを世界に向けて公開するには、nginx等のWebサーバやプロキシサーバを
Akkomaの前段に使用する必要があります。また、Akk
oma のためにシステムサービスファイルを作成する必要があります。
#### Nginx
#### Nginx
@@
-133,8
+143,8
@@
sudo certbot certonly --email <your@emailaddress> -d <yourdomain> --standalone
* nginxの設定ファイルサンプルをnginxフォルダーにコピーします。
```
* nginxの設定ファイルサンプルをnginxフォルダーにコピーします。
```
-sudo cp /opt/
pleroma/installation/pleroma.nginx /etc/nginx/sites-available/pler
oma.nginx
-sudo ln -s /etc/nginx/sites-available/
pleroma.nginx /etc/nginx/sites-enabled/pler
oma.nginx
+sudo cp /opt/
akkoma/installation/akkoma.nginx /etc/nginx/sites-available/akk
oma.nginx
+sudo ln -s /etc/nginx/sites-available/
akkoma.nginx /etc/nginx/sites-enabled/akk
oma.nginx
```
* nginxを起動する前に、設定ファイルを編集してください。例えば、サーバー名、証明書のパスなどを変更する必要があります。
```
* nginxを起動する前に、設定ファイルを編集してください。例えば、サーバー名、証明書のパスなどを変更する必要があります。
@@
-150,19
+160,19
@@
sudo certbot certonly --email <your@emailaddress> -d <yourdomain> --webroot -w /
```
#### 他のWebサーバやプロキシ
```
#### 他のWebサーバやプロキシ
-これに関してはサンプルが `/opt/
pler
oma/installation/` にあるので、探してみてください。
+これに関してはサンプルが `/opt/
akk
oma/installation/` にあるので、探してみてください。
#### Systemd サービス
* サービスファイルのサンプルをコピーします。
```
#### Systemd サービス
* サービスファイルのサンプルをコピーします。
```
-sudo cp /opt/
pleroma/installation/pleroma.service /etc/systemd/system/pler
oma.service
+sudo cp /opt/
akkoma/installation/akkoma.service /etc/systemd/system/akk
oma.service
```
* サービスファイルを変更します。すべてのパスが正しいことを確認してください
```
* サービスファイルを変更します。すべてのパスが正しいことを確認してください
-* サービスを有効化し `
pler
oma.service` を開始してください
+* サービスを有効化し `
akk
oma.service` を開始してください
```
```
-sudo systemctl enable --now
pler
oma.service
+sudo systemctl enable --now
akk
oma.service
```
#### 初期ユーザの作成
```
#### 初期ユーザの作成
@@
-170,16
+180,9
@@
sudo systemctl enable --now pleroma.service
新たにインスタンスを作成したら、以下のコマンドにより管理者権限を持った初期ユーザを作成できます。
```
新たにインスタンスを作成したら、以下のコマンドにより管理者権限を持った初期ユーザを作成できます。
```
-sudo -Hu
pler
oma MIX_ENV=prod mix pleroma.user new <username> <your@emailaddress> --admin
+sudo -Hu
akk
oma MIX_ENV=prod mix pleroma.user new <username> <your@emailaddress> --admin
```
#### その他の設定とカスタマイズ
{! backend/installation/further_reading.include !}
```
#### その他の設定とカスタマイズ
{! backend/installation/further_reading.include !}
-
-## 質問ある?
-
-インストールについて質問がある、もしくは、うまくいかないときは、以下のところで質問できます。
-
-* [#pleroma:matrix.org](https://matrix.heldscal.la/#/room/#freenode_#pleroma:matrix.org)
-* **Freenode** の **#pleroma** IRCチャンネル