ting-server

Server side code of Ting.

Getting Started

Prerequisite

1. Amazon S3
   1. Create a bucket
   2. Edit Cross-origin resource sharing (CORS) setting under the Permissions tab to add an allowed origin (the host of ting-app):

      [
          {
              "AllowedHeaders": [
                  "*"
              ],
              "AllowedMethods": [
                  "PUT",
                  "GET"
              ],
              "AllowedOrigins": [
                  "http://example.com"
              ],
              "ExposeHeaders": []
          }
      ]
      

2. Amazon Simple Email Service
   1. Add a verified identity
3. AWS IAM User
   1. Create an IAM user that has the permission:

      {
           "Version": "2012-10-17",
           "Statement": [
               {
                   "Effect": "Allow",
                   "Action": [
                       "ses:SendEmail",
                       "ses:SendRawEmail"
                   ],
                   "Resource": "*"
               },
               {
                   "Effect": "Allow",
                   "Action": [
                       "s3:PutObject",
                       "s3:GetObject"
                   ],
                   "Resource": "arn:aws:s3:::example-ting-bucket/*"
               }
           ]
       }
      

   2. Export AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY as environment variables
4. Create a MySQL database called ting, then import table structures with schema.sql and initialize initial data with initial_data.sql

Run with Docker

sudo docker run -e MYSQL_HOST=your_mysql_host \
  -e MYSQL_USER=your_mysql_user \
  -e MYSQL_PASSWORD=your_mysql_user_password \
  -e REDIS_HOST=your_redis_host \
  -e REDIS_PORT=6379 \
  -e TING_CONFIRM_REGISTRATION_RETURN_URL=https://ting.dekiru.app/#/confirmRegistration \
  -e TING_ALLOWED_ORIGIN=https://ting.dekiru.app \
  -e AWS_SES_REGION=your_ses_region \
  -e [email protected] \
  -e AWS_S3_REGION=your_s3_region \
  -e AWS_S3_BUCKET_NAME=ting-static \
  -e AWS_ACCESS_KEY_ID=your_aws_access_key \
  -e AWS_SECRET_ACCESS_KEY=your_aws_secret_access_key \
  -p 8080:8080 \
  -d xiaodanmao/ting-server:latest

License

MIT