Documentation

Creating Your First Configuration

Learn how to set up a complete export configuration from Akeneo PIM to your database.

What You'll Learn: Configure Akeneo source, database destination, enrichers, and export settings.

Overview

A configuration is a reusable template for exporting products from Akeneo PIM to your database. Create once, use repeatedly.

🔌Source

Akeneo PIM

đŸ—„ī¸Destination

MongoDB / PostgreSQL

✨Enrichers

Transformations

🔍Filters

Product selection

⏰Schedule

Manual / Auto

1

Navigate to Configurations

1

Log in to your dashboard

2

Click Configurations in the sidebar

3

Click New Configuration

2

Configure Akeneo Source

Connect to your Akeneo PIM. Choose your authentication method:

Authentication Method

Recommended

OAuth 2.0

Secure authorization flow. Click the button, authorize in Akeneo, credentials auto-filled.

✓ No manual credential entry
✓ Automatic token refresh
✓ Most secure option

API Credentials

Manual entry from Akeneo System → API connections.

â€ĸ Client ID + Secret
â€ĸ Username + Password
â€ĸ For advanced setups

Common Fields

📝Name: "Production E-commerce"
🌐URL: your-company.cloud.akeneo.com

Scope & Locales

đŸ“ēScope: Channel (ecommerce, b2b...)
đŸ—Ŗī¸Available Locales: Languages activated

💡 Multi-Channel: Create one configuration per channel with separate databases for isolation.

3

Configure Destination

Choose where your product data will be stored. Your data stays in your database.

🍃

MongoDB

Flexible schema, nested data, e-commerce

bash
mongodb://user:pass@host:27017/db
  ?ssl=true
🐘

PostgreSQL

Relational queries, SQL analytics

bash
postgresql://user:pass@host:5432/db
  ?sslmode=require

âš ī¸ Firewall: Whitelist our IP addresses. Contact support for the list.

4

Test Connections

Validate credentials and permissions before saving.

✅
Test Akeneo Connection

Validates OAuth & read permissions

✅
Test Database Connection

Verifies network & write permissions

Common issues: Wrong ports (443/27017/5432), firewall blocking, insufficient permissions.

5

Export Options (Optional)

Configure enrichers and filters to customize your export.

Enrichers

📁Categories: Full path & labels
đŸˇī¸Attributes: Labels & options
🔗Entities: Reference data

Filters

đŸ‘ĒBy families (clothing, shoes...)
📁By categories
✅By enabled status
6

Save Configuration

1

Review all settings one final time

2

Click Save Configuration

3

Redirected to configuration details → Ready to export!

🎉 Configuration Created! Your configuration is ready. Run your first export now!

Next Steps

â„šī¸ Need Help? Check our Troubleshooting guide.