{"_id":"56ce160ae538330b0021ac39","parentDoc":null,"__v":9,"category":{"_id":"56cedc8ce50c9c1b00830423","__v":1,"pages":["56d763c2693ef41d0003abec"],"project":"552829408962f339009a678d","version":"552829408962f339009a6790","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-02-25T10:50:52.142Z","from_sync":false,"order":8,"slug":"server-configuration","title":"Server Configuration"},"project":"552829408962f339009a678d","user":"55282916d9e1db2d00cd923c","version":{"_id":"552829408962f339009a6790","project":"552829408962f339009a678d","__v":26,"createdAt":"2015-04-10T19:49:20.516Z","releaseDate":"2015-04-10T19:49:20.516Z","categories":["552829418962f339009a6791","55284ed68962f339009a67e1","55286c73391a362500d9b3f4","552918f6b316811900149f59","5529b255d739240d00a3483e","553287590a578a0d008d4ff5","55329385e7d1fa0d003fc946","5550b55200420e0d00d1312f","55525fca953c9c0d00f507d7","559199695631432f002d358a","559d8d96980b801700d5ec7e","55c5e833cccdeb2d004e24b9","55d76504f662951900fc0e7d","55ea213cc62aa02f008229cd","56157b750f5ed00d00483dd8","561981fbac0924170069f4e8","561b8b1ea430930d0037ea67","563417428b86331700b488ca","56cd785bface161300dae0ec","56cdcc6e70db8a15006395f4","56cdf1b749abf10b0036a34a","56cedc8ce50c9c1b00830423","56e97ba8d825061900d1ac83","570d505228e6900e00477229","573614ca2ab52e1700c8e851","57d556a2496a3117004d70cf"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-02-24T20:43:54.093Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"For file transfer feature you need to configure file storage module. Open Source version of Actor supports Amazon S3 based storage or local file storage.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Local File Storage\"\n}\n[/block]\nLocal file storage is enabled by default in Actor Server Open-Source edition. Default location for files is `/var/lib/actor/files`. If you want to use different location - just fill in file storage location in your `server.conf` like this:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"http {\\n  # provide uri on which your server's http endpoint is available, default is http://ip:9090\\n  base-uri: \\\"http://ip:port\\\"\\n}\\n\\nservices {\\n  file-storage {\\n    # provide your own path to directory with read and write permissions for user `actor`\\n    location: \\\"/home/username/actor/files\\\"\\n  }\\n}\",\n      \"language\": \"text\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Amazon S3\"\n}\n[/block]\nAmazon S3 support is bundled in Actor Open Source Edition and can be easily enabled by following next steps.\n\n# Step 1: Create Bucket\nCreate a bucket with CORS enabled with the following configuration:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\"?>\\n<CORSConfiguration xmlns=\\\"http://s3.amazonaws.com/doc/2006-03-01/\\\">\\n    <CORSRule>\\n        <AllowedOrigin>*</AllowedOrigin>\\n        <AllowedMethod>GET</AllowedMethod>\\n        <AllowedMethod>PUT</AllowedMethod>\\n        <MaxAgeSeconds>3000</MaxAgeSeconds>\\n        <AllowedHeader>*</AllowedHeader>\\n    </CORSRule>\\n</CORSConfiguration>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]\n# Step 2: Enable S3 Support in Actor\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"modules {\\n  files {\\n    adapter: \\\"im.actor.server.file.s3.S3StorageAdapter\\\"\\n  }\\n}\\nservices {\\n  aws {\\n    s3 {\\n      default-bucket: \\\"<bucket name>\\\"\\n      access-key: \\\"<your aws access key>\\\"\\n      secret-key: \\\"<your aws secret key>\\\"\\n    }\\n  }\\n}\",\n      \"language\": \"text\"\n    }\n  ]\n}\n[/block]","excerpt":"Configure one of available file storages","slug":"file-storage-configuration","type":"basic","title":"File Storage configuration"}

File Storage configuration

Configure one of available file storages

For file transfer feature you need to configure file storage module. Open Source version of Actor supports Amazon S3 based storage or local file storage. [block:api-header] { "type": "basic", "title": "Local File Storage" } [/block] Local file storage is enabled by default in Actor Server Open-Source edition. Default location for files is `/var/lib/actor/files`. If you want to use different location - just fill in file storage location in your `server.conf` like this: [block:code] { "codes": [ { "code": "http {\n # provide uri on which your server's http endpoint is available, default is http://ip:9090\n base-uri: \"http://ip:port\"\n}\n\nservices {\n file-storage {\n # provide your own path to directory with read and write permissions for user `actor`\n location: \"/home/username/actor/files\"\n }\n}", "language": "text" } ] } [/block] [block:api-header] { "type": "basic", "title": "Amazon S3" } [/block] Amazon S3 support is bundled in Actor Open Source Edition and can be easily enabled by following next steps. # Step 1: Create Bucket Create a bucket with CORS enabled with the following configuration: [block:code] { "codes": [ { "code": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<CORSConfiguration xmlns=\"http://s3.amazonaws.com/doc/2006-03-01/\">\n <CORSRule>\n <AllowedOrigin>*</AllowedOrigin>\n <AllowedMethod>GET</AllowedMethod>\n <AllowedMethod>PUT</AllowedMethod>\n <MaxAgeSeconds>3000</MaxAgeSeconds>\n <AllowedHeader>*</AllowedHeader>\n </CORSRule>\n</CORSConfiguration>", "language": "xml" } ] } [/block] # Step 2: Enable S3 Support in Actor [block:code] { "codes": [ { "code": "modules {\n files {\n adapter: \"im.actor.server.file.s3.S3StorageAdapter\"\n }\n}\nservices {\n aws {\n s3 {\n default-bucket: \"<bucket name>\"\n access-key: \"<your aws access key>\"\n secret-key: \"<your aws secret key>\"\n }\n }\n}", "language": "text" } ] } [/block]