OBS Download page

Using OBS download pages

Welcome to the OBS download page. This page offers a simple way to show your users the latest builds of your packages and appliances by either embedding its output as an iframe in your project homepage, or by creating a download page for you.

Creating a download page for a package

Just create a link to


for example: https://software.opensuse.org/download/package?project=openSUSE:Tools&amp;package=osc.

To embed this page as an iframe in the download section of your project homepage, you can use this code:

<iframe src="https://software.opensuse.org/download/package.iframe?project=<projectname>&package=<packagename>"></iframe>

Which will result in an output like this:

Creating a download page for a pattern

Linking to a pattern is similar to the way described above for a package, just change the url to use pattern:


Creating a download page for an appliance

If your OBS project is building appliances, you can also link to those with:


To embed an iframe showing the appliances of your project, use this code:

<iframe src="https://software.opensuse.org/download/appliance.iframe?project=<projectname>"></iframe>

Which will result in an output like this:

Advanced options

JSON output: You can also request the data in json format by using .json as output format, for example: https://software.opensuse.org/download/package.json?project=openSUSE:Tools&package=obs-server.

Theming: To customize the theming of the download page, you have multiple options to change the colors. Use the parameters bcolor, fcolor, hcolor and acolor to set the different colors.
Example: https://software.opensuse.org/download/appliance.iframe?project=openSUSE:Tools&fcolor=607890&hcolor=607890&acolor=607890&bcolor=123