Ubuntu is an open source software operating system that runs from the desktop, to the cloud, to all your internet connected things. Ubuntu.com is the website that helps people learn about, download and get started with Ubuntu. This repo is the codebase and content for the ubuntu.com website.
The site is largely maintained by the Web and Design team at Canonical. It is a simple, database-less, informational website project based on Flask and hosted on a Charmed Kubernetes cluster.
You can read more about the application's architecture in ARCHITECTURE.md.
If you have found a bug on the site or have an idea for a new feature, feel free to create a new issue, or suggest a fix by creating a pull request. You can also find a link to create issues in the footer of every page of the site itself.
If you have found a bug in the Ubuntu OS itself, please file it here.
Recommended: use Taskfile
Install Taskfile by following the official installation docs: taskfile.dev/docs/installation.
Run the project with:
task
# or
# task startWarning
Deprecated: dotrun
Using the dotrun snap to run this project is now deprecated and will be removed in the future. If you still rely on it, please see the installation instructions in the dotrun README and run dotrun as before. On macOS, if dotrun errors due to Chromium, add the following to your local .env.local file:
PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true
Once the server has started, you can visit http://127.0.0.1:8001 in your browser.
For more information on how to work with ubuntu.com project please refer to HACKING.md.
You can find the deployment config in the deploy folder.
The content of this project is licensed under the Creative Commons Attribution-ShareAlike 4.0 International license, and the underlying code used to format and display that content is licensed under the LGPLv3 by Canonical Ltd.
With ♥ from Canonical