akkoma/README.md
Your Name db1aa771f1 fix
2022-11-27 15:38:11 -07:00

58 lines
1.4 KiB
Markdown

# Quickly Run Akkoma in Docker
This setup will allow you to quickly run and maintain a Akkoma instance.
### Features
* Mostly Automated Install
* Automatic Backup
* Automatic Restorea
* Automatic Upgrades
* Daily Postgresql backups
### System Requirements
* Your own Domain Name
* Docker installed
* Cloudflare setup for your Domain Name (Or do certbot manually after the instance is up)
* Port 443 open on your firewall/router
### Getting Started
##### Modify ```terms-of-service.html``` with your terms of service
##### Modify ```ENDPOINT``` in ```docker-compose.yml``` with your domain name
##### Modify the second to last line in ```akkoma/setup.sh``` with your desired admin name
### Running with a low-memory machine? ###
Here is the recommended changes to make at the bottom of ```postgresql/postgresql.conf```
```
max_connections = 200
shared_buffers = 128MB
effective_cache_size = 384MB
maintenance_work_mem = 32MB
checkpoint_completion_target = 0.9
wal_buffers = 3932kB
default_statistics_target = 100
random_page_cost = 4
effective_io_concurrency = 2
work_mem = 327kB
min_wal_size = 1GB
max_wal_size = 4GB
```
##### Build and Start Akkoma
```
git checkout HEAD config/config.exs
docker-compose up -d
```
##### Get the URL to change the Pleromp Admin user
```
docker-compose logs -f
```
The URL will let you set the admin password so you can login your instance.