Quick Start
Get your AS2 gateway running in 15 minutes with a single command.
Prerequisites
Before you begin, ensure you have:
- An AWS Account with appropriate permissions
- AWS CLI installed and configured
- Node.js 18+ installed (for CDK)
If you haven't configured AWS CLI, run aws configure and enter your Access Key ID, Secret Access Key, and preferred region.
Installation
Open AWS CloudShell in your AWS Console and run the one-command installer:
This will automatically:
- Clone the repository
- Install dependencies
- Bootstrap CDK (if needed)
- Deploy all stacks to your AWS account
The deployment typically completes in 10-15 minutes. You'll see progress output as each resource is created.
First-Time Setup
After logging in, complete these steps to start exchanging messages:
Create AS2 Instance
Navigate to AS2 Instances and click + Create AS2 Instance. Enter your company's AS2 ID, name, alias, and email address. Learn more
Add Trading Partner
Go to Partner tab and click + Create Partner. Enter your trading partner's AS2 ID, name, alias, and email. Learn more
Create Certificate
In the Certificate tab, click + Create Cert. Upload your partner's public certificate for encryption. Importing your own certificate is optional — if you don't have one, ServerlessAS2 will automatically generate one for you. Learn more
Create Partnership
Go to AS2 Instances and click on your instance to edit it. In the Related Partnership section, click the + button to create a new partnership. Learn more about partnerships.
Send Test File
Navigate to Send File, select your partnership, upload an EDI file, and click Send File to transmit your first message. Learn more
Track Your Message
Check the TrackLog to monitor your message status. You'll see "MDN Saved" when your partner successfully receives and acknowledges the message. Learn more
1. Create AS2 Instance
Set up your AS2 identity with your company's AS2 ID.
2. Add Partner
Configure your trading partner's details and AS2 endpoint.
3. Exchange Certificates
Upload your certificate and your partner's public certificate.
4. Send Test Message
Send a test file to verify the connection works.
While Serverless AS2 is open source, AWS charges for resource usage. Low-volume usage typically stays within the AWS Free Tier ($0/month). See our cost estimator for projected costs.