Product SiteDocumentation Site

Chapter 2. Prerequisites for using a Zanata instance

2.1. Prerequisites for using the Fedora Zanata instance
2.2. Install a Zanata client
2.2.1. Python Client
2.2.2. Maven Client

2.1. Prerequisites for using the Fedora Zanata instance

Procedure 2.1. Create a Fedora Account System (FAS) account
You need a FAS (Fedora Account System) account to use the Fedora Zanata instance. Follow this procedure to create a FAS account if you do not already have one.
  1. Go to https://admin.fedoraproject.org/accounts/
  2. Click "New Account"
  3. Fill in your details and sign up
    Result:
    You have a FAS account for use with the Fedora Zanata instance.
Procedure 2.2. Validate your Fedora Zanata account
  1. Log in to https://fedora.zanata.org using your FAS account.
  2. The first time you sign in you are presented with an "Edit Profile" form pre-filled with your username and a suggested email address. Make sure that the email address is correct, modify it if necessary, and click "Save".
  3. Check your email for the validation email. Click the link in the email to validate your FAS account for access to Zanata.
Procedure 2.3. Configure your local machine with credentials for fedora.zanata.org
  1. Use your FAS credentials to login at https://fedora.zanata.org.
  2. Click "My Profile"
  3. If you do not have a current API key, click "Regenerate API key"
  4. Copy the API key value
  5. Create the file ~/.config/zanata.ini
  6. Paste the following into the file, replacing the username and key values with your FAS username and the API key, respectively: 
    [defaults]
debug = false
[servers]
fedora.url = https://fedora.zanata.org/zanata
fedora.username = <your FAS name>
fedora.key = <API key>
    Result:
    Your machine is now configured to communicate with the Fedora Zanata instance.