cannery/README.md

87 lines
3.4 KiB
Markdown
Raw Normal View History

2021-03-11 21:12:55 -05:00
# Cannery is a personal ammo manager that adjusts to your own needs.
* Easy to Use: Cannery lets you easily keep an eye on your ammo levels before
and after range day
* Secure: Self-host your own instance, or use an instance from someone you
trust. Your data stays with you, period
2022-01-21 20:36:25 -05:00
* Simple: Access from any internet-capable device
2022-01-23 00:02:22 -05:00
# Features
2022-01-31 20:04:38 -05:00
- Create containers to store your ammunition, and tag them with custom tags
- Add ammunition types to Cannery, and then ammunition groups to your containers
- Invitations via invite tokens or public registration
2022-01-23 00:02:22 -05:00
# Installation
1. Install [Docker Compose](https://docs.docker.com/compose/install/) or alternatively [Docker Desktop](https://docs.docker.com/desktop/) on your machine.
2022-01-31 20:04:38 -05:00
1. Copy the example `docker-compose.yml` into your local machine where you want.
Bind mounts are created in the same directory by default.
1. Set the configuration variables in `docker-compose.yml`. You'll need to run
`docker run -it shibaobun/cannery mix phx.gen.secret` to generate a new
secret key base.
1. Use `docker-compose up` or `docker-compose up -d` to start the container!
The first created user will be created as an admin.
2022-01-23 00:02:22 -05:00
2022-01-31 20:04:38 -05:00
## Reverse proxy
2022-01-23 00:02:22 -05:00
Finally, reverse proxy to port `4000` of the container. If you're using a reverse proxy in another docker container, you can reverse proxy to `http://cannery:4000`. Otherwise, you'll need to modify the `docker-compose.yml` to bind the port to your local machine.
2022-01-23 00:02:22 -05:00
2022-01-31 20:04:38 -05:00
For instance, instead of
```
expose:
- "4000"
2022-01-31 20:04:38 -05:00
```
2022-01-23 00:02:22 -05:00
2022-01-31 20:04:38 -05:00
use
```
ports:
- "127.0.0.1:4000:4000"
2022-01-31 20:04:38 -05:00
```
and reverse proxy to `http://localhost:4000`.
2022-01-23 00:02:22 -05:00
2022-01-31 20:04:38 -05:00
# Configuration
2022-01-23 00:02:22 -05:00
2022-01-31 20:04:38 -05:00
You can use the following environment variables to configure Cannery in
`docker-compose.yml`.
2022-01-23 00:02:22 -05:00
- `HOST`: External url to generate links with. Must be set with your hosted
domain name! I.e. `cannery.mywebsite.tld`
- `PORT`: Internal port to bind to. Defaults to `4000`. Must be reverse proxied!
2022-01-23 00:02:22 -05:00
- `DATABASE_URL`: Controls the database url to connect to. Defaults to
`ecto://postgres:postgres@cannery-db/cannery`.
- `ECTO_IPV6`: If set to `true`, Ecto should use ipv6 to connect to PostgreSQL.
2022-01-23 00:02:22 -05:00
Defaults to `false`.
- `POOL_SIZE`: Controls the pool size to use with PostgreSQL. Defaults to `10`.
- `SECRET_KEY_BASE`: Secret key base used to sign cookies. Must be generated
with `docker run -it shibaobun/cannery mix phx.gen.secret` and set for server to start.
- `REGISTRATION`: Controls if user sign-up should be invite only or set to
public. Set to `public` to enable public registration. Defaults to `invite`.
2022-02-07 19:30:21 -05:00
- `LOCALE`: Sets a custom locale. Defaults to `en_US`.
2022-01-23 00:36:35 -05:00
2022-01-31 20:04:38 -05:00
# Contribution
Contributions are greatly appreciated, no ability to code needed! You can browse
the [Contribution
Guide](https://gitea.bubbletea.dev/shibao/cannery/src/branch/stable/CONTRIBUTING.md)
to learn more.
2022-01-31 20:04:38 -05:00
I can be contacted at [shibao@bubbletea.dev](mailto:shibao@bubbletea.dev), or on
the fediverse at
[@shibao@misskey.bubbletea.dev](https://misskey.bubbletea.dev/@shibao). Thank
you!
# License
Cannery is licensed under AGPLv3 or later. A copy of the latest version of the
license can be found at
[LICENSE.md](https://gitea.bubbletea.dev/shibao/cannery/src/branch/stable/LICENSE.md).
2022-01-31 20:04:38 -05:00
---
2022-01-23 00:36:35 -05:00
[![Build
Status](https://drone.bubbletea.dev/api/badges/shibao/cannery/status.svg?ref=refs/heads/dev)](https://drone.bubbletea.dev/shibao/cannery)
[![translation
status](https://weblate.bubbletea.dev/widgets/cannery/-/svg-badge.svg)](https://weblate.bubbletea.dev/engage/cannery/)