From Wikitech
Jump to navigation Jump to search


This page contains reference information about the Toolforge hosting environment, the basics of using Tool Accounts and working with co-maintainers, essential workflows you'll need to follow, and the software and tools you'll need to create successful tools.

Follow the Toolforge Quickstart guide to start using Toolforge to create and maintain tools.

About Toolforge

About Toolforge page will help you understand what Toolforge is, some of its features, and how it is structured.

Tool Accounts

Tool Accounts will help you understand what a Tool Account is, the first steps to create a Tool Account/tool, basic configurations and commands, and how to add and remove maintainers.

Rules, policies, and best practices for using Toolforge

Understand the rules and policies you must follow in order to participate with Toolforge, and learn more about best practices for developing with Toolforge.

Create a Wikimedia developer account

A Wikimedia developer account is required in addition to a Wikimedia account, if you plan to access, use, and make contributions to Wikimedia's protected services, including Toolforge.

How-To and Developer Stories

The How-to page contains walk-throughs, tutorials, and developer stories.

Version Control in Toolforge

See Version control in Toolforge to learn how version control tools help you collaborate with other tool maintainers, and help you manage files and backups in your Tool Accounts. The linked page covers using Git and the variety of options available for you to create and manage repositories.

Database access

See the Toolforge database page for more information about database access. This page also contains code samples in a variety of languages.


See the Toolforge Kubernetes page for more information about the system that is used for launching web applications and jobs in Toolforge.

Email in Toolforge

See the Email page for more information on sending email to and from various parts of Toolforge.

Web services

See the Web page for information about creating Tools with a Web service component using PHP, Python, or other programming languages.


See Elasticsearch for information about using Elasticsearch with Toolforge.

Redis for Toolforge

See Redis for Toolforge for more information.

Dumps in Toolforge

See Toolforge dumps to access information about dumps in Toolforge.

Troubleshooting Toolforge

See Troubleshooting Toolforge for information about common issues and errors and to learn more about how to report problems when you encounter them.

Communication and support

Support and administration of the WMCS resources is provided by the Wikimedia Foundation Cloud Services team and Wikimedia Movement volunteers. Please reach out with questions and join the conversation:

Discuss and receive general support
Receive mail announcements about critical changes
Subscribe to the cloud-announce@ mailing list (all messages are also mirrored to the cloud@ list)
Track work tasks and report bugs
Use a subproject of the #Cloud-Services Phabricator project to track confirmed bug reports and feature requests about the Cloud Services infrastructure itself
Learn about major near-term plans
Read the News wiki page
Read news and stories about Wikimedia Cloud Services
Read the Cloud Services Blog (for the broader Wikimedia movement, see the Wikimedia Technical Blog)

See also