shibao/cannery
shibao/cannery
1
2
Fork 1
Code Issues 16 Pull Requests Projects 1 Releases 36 Wiki Activity
The self-hosted firearm tracker app
426 Commits 3 Branches 37 Tags 13 MiB
Elixir 79.3%
HTML 18.3%
JavaScript 1.4%
SCSS 0.8%
Dockerfile 0.2%
fa3fb1c876
Go to file
pehoulihan fa3fb1c876
Some checks reported errors
continuous-integration/drone/push Build encountered an error
Details
Translated using Weblate (Irish) 
Currently translated at 57.5% (19 of 33 strings)

Translation: cannery/errors
Translate-URL: https://weblate.bubbletea.dev/projects/cannery/errors/ga/
2022-11-07 00:18:31 +00:00
assets add logo 😄 2022-07-04 20:19:03 -04:00
config add translation properly 2022-04-19 18:16:06 -04:00
lib mix format 2022-07-05 01:13:38 -04:00
priv Translated using Weblate (Irish) 2022-11-07 00:18:31 +00:00
test harden invite changesets 2022-07-04 21:09:55 -04:00
.credo.exs fix credo 2022-03-28 23:05:12 -04:00
.drone.yml remove arm/v6 2022-07-30 15:23:18 -04:00
.formatter.exs remove unneeded formatter dep 2022-04-19 19:42:48 -04:00
.gitignore add .vscode dir to gitignore 2022-01-27 00:57:03 -05:00
.tool-versions use elixir 1.13.4 2022-04-19 20:23:31 -04:00
CHANGELOG.md add logo as favicon 2022-07-05 01:09:47 -04:00
CONTRIBUTING.md add logo contribution 2022-07-04 20:47:12 -04:00
docker-compose.yml fix docker compose 2022-02-18 17:47:30 -05:00
Dockerfile use elixir 1.13.4 2022-04-19 20:23:31 -04:00
home.png update screenshot lol 2022-07-04 21:52:08 -04:00
LICENSE.md - add translation status to readme and contributing guide 2022-02-07 23:31:21 -05:00
mix.exs add logo as favicon 2022-07-05 01:09:47 -04:00
mix.lock update deps 2022-05-06 23:36:39 -04:00
README.md remove logo from readme lol 2022-07-04 21:55:57 -04:00

README.md

Cannery

old screenshot

The self-hosted firearm tracker website.

  • 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
  • Simple: Access from any internet-capable device

Features

  • Create containers to store your ammunition, and tag them with custom tags
  • Add ammunition types to Cannery, and then ammunition groups to your containers
  • Stage groups of ammo for range day and record your ammo usage
  • Invitations via invite tokens or public registration

Installation

  1. Install Docker Compose or alternatively Docker Desktop on your machine.
  2. Copy the example docker-compose.yml. into your local machine where you want. Bind mounts are created in the same directory by default.
  3. Set the configuration variables in docker-compose.yml. You'll need to run docker run -it shibaobun/cannery /app/priv/random.sh to generate a new secret key base.
  4. Use docker-compose up or docker-compose up -d to start the container!

The first created user will be created as an admin.

Reverse proxy

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.

For instance, instead of

expose:
  - "4000"

use

ports:
  - "127.0.0.1:4000:4000"

and reverse proxy to http://localhost:4000.

Configuration

You can use the following environment variables to configure Cannery in docker-compose.yml.

  • 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!
  • 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. 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.
  • LOCALE: Sets a custom default locale. Defaults to en_US
    • Available options: en_US, de, and fr
  • SMTP_HOST: The url for your SMTP email provider. Must be set
  • SMTP_PORT: The port for your SMTP relay. Defaults to 587.
  • SMTP_USERNAME: The username for your SMTP relay. Must be set!
  • SMTP_PASSWORD: The password for your SMTP relay. Must be set!
  • SMTP_SSL: Set to true to enable SSL for emails. Defaults to false.
  • EMAIL_FROM: Sets the sender email in sent emails. Defaults to no-reply@HOST where HOST was previously defined.
  • EMAIL_NAME: Sets the sender name in sent emails. Defaults to "Cannery".

Contribution

Contributions are greatly appreciated, no ability to code needed! You can browse the Contribution Guide to learn more.

I can be contacted at shibao@bubbletea.dev, or on the fediverse at @shibao@misskey.bubbletea.dev. 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.

Build Status translation status