Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

82 Commits

Repository files navigation

Anope

Anope is a set of IRC Services designed for flexibility and ease of use.

Anope is a set of Services for IRC networks that allows users to manage their nicks and channels in a secure and efficient way, and administrators to manage their network with powerful tools.

How to use this image

This image is not usable as stand alone image. You need some kind of IRCd.

For example you can use InspIRCd like in the example.

The minimal configuration looks like this:

$ docker run --name anope -e "ANOPE_UPLINK_IP=irc.example.org" -e "ANOPE_UPLINK_PASSWORD=password" anope/anope

You can use your own configs in this container by mounting them to /anope/conf/:

$ docker run --name anope -v /path/to/your/config:/anope/conf/ anope/anope

Generated configuration

This image provides various options to configure it by environment variables.

Use the following environment variables to configure your container:

Available variablesDefault valueDescription
ANOPE_SERVICES_NAMEservices.localhost.netName of the services. Important for uplink
ANOPE_SERVICES_VHOSTservices.localhost.netHost used by services pseudo clients
ANOPE_UPLINK_IPno defaultDNS name or IP of the uplink host
ANOPE_UPLINK_PORT7000Port used to connect to uplink host
ANOPE_UPLINK_PASSWORDno defaultPassword used to authenticate against uplink

Database configuration

This image provides two way to configure database handling. You can use sqlite inside a volume or an external mysqldb.

SQLite is used by default to prevent failing of the container, but mysql is recommended.

SQLite

For very small setup, development and testing SQLite setup should be enough. Simply make sure you mount a volume to /data.

$ docker run --name anope -v "/path/to/datastore:/data" -e "ANOPE_UPLINK_IP=irc.example.org" -e "ANOPE_UPLINK_PASSWORD=password" anope/anope

MySQL

For a production setup MySQL is the recommended way to set this image up. Checkout the example if you want to test it.

Available variablesDefault valueDescription
ANOPE_SQL_ENGINEsqliteSet it to mysql to enable mysql backend
ANOPE_MYSQL_DBanopeDatabase name for the data
ANOPE_MYSQL_HOSTdatabaseHostname of the database host or container
ANOPE_MYSQL_PORT3306Port used to access the mysql database
ANOPE_MYSQL_USERanopeUsername for the MySQL database
ANOPE_MYSQL_PASSWORDno defaultPassword for the ANOPE_MYSQL_USER
ANOPE_SQL_LIVEnoEnable Anope SQL-DB live feature

Updates and updating

To update your setup simply pull the newest image version from docker hub and run it.

$ docker pull anope/anope

Considering to update your docker setup regularly.

License

View license information for the software contained in this image.

Supported Docker versions

This image is officially supported on Docker version 17.03.1-CE.

Support for older versions (down to 1.12) is provided on a best-effort basis.

Please see the Docker installation documentation for details on how to upgrade your Docker daemon.

User Feedback

Issues

If you have any problems with or questions about this image, please contact us through a GitHub issue.

You can also reach many of the project maintainers via the #anope IRC channel on Teranova.

Contributing

You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.

About

Anope Docker image

Topics

Resources

Stars

18 stars

Watchers

10 watching

Forks

Used by

Contributors

Languages