Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Configuration options 

mythz edited this page · 11 revisions


  1. Getting Started
    1. Create your first webservice
    2. Your first webservice explained
    3. ServiceStack's new API Design
    4. Designing a REST-ful service with ServiceStack
    5. Example Projects Overview
  2. Reference
    1. Order of Operations
    2. The IoC container
    3. Metadata page
    4. Rest, SOAP & default endpoints
    5. SOAP support
    6. Routing
    7. Service return types
    8. Customize HTTP Responses
    9. Plugins
    10. Validation
    11. Error Handling
    12. Security
    13. Debugging
  3. Clients
    1. Overview
    2. C# client
    3. Silverlight client
    4. JavaScript client
    5. Dart Client
    6. MQ Clients
  4. Formats
    1. Overview
    2. JSON/JSV and XML
    3. ServiceStack's new HTML5 Report Format
    4. ServiceStack's new CSV Format
    5. MessagePack Format
    6. ProtoBuf Format
  5. View Engines
    1. Razor & Markdown Razor
    2. Markdown Razor
  6. Hosts
    1. IIS
    2. Self-hosting
    3. Messaging
    4. Mono
  7. Security
    1. Authentication/authorization
    2. Sessions
    3. Restricting Services
  8. Advanced
    1. Configuration options
    2. Access HTTP specific features in services
    3. Logging
    4. Serialization/deserialization
    5. Request/response filters
    6. Filter attributes
    7. Concurrency Model
    8. Built-in caching options
    9. Built-in profiling
    10. Form Hijacking Prevention
    11. Auto-Mapping
    12. HTTP Utils
    13. Virtual File System
    14. Config API
    15. Physical Project Structure
    16. Modularizing Services
    17. MVC Integration
  9. Plugins
    1. Auto Query
    2. Request logger
    3. Swagger API
    4. Postman
  10. Tests
    1. Testing
    2. HowTo write unit/integration tests
  11. Other Languages
    1. FSharp
    2. VB.NET
  12. Use Cases
    1. Single Page Apps
    2. Azure
    3. Logging
    4. Bundling and Minification
    5. NHibernate
  13. Performance
    1. Real world performance
  14. How To
    1. Sending stream to ServiceStack
    2. Setting UserAgent in ServiceStack JsonServiceClient
    3. ServiceStack adding to allowed file extensions
    4. Default web service page how to
  15. Future
    1. Roadmap
Clone this wiki locally

As you might have seen in the last tutorials, the main configuration is made in the app host Configure method.

//Set JSON web services to return idiomatic JSON camelCase properties   
ServiceStack.Text.JsConfig.EmitCamelCaseNames = true;
//Change the default ServiceStack configuration
Feature disableFeatures = Feature.Jsv | Feature.Soap;
SetConfig(new EndpointHostConfig {
    EnableFeatures = Feature.All.Remove(disableFeatures), //all formats except of JSV and SOAP
    DebugMode = true, //Show StackTraces in service responses during development
    WriteErrorsToResponse = false, //Disable exception handling
    DefaultContentType = ContentType.Json, //Change default content type
    AllowJsonpRequests = true //Enable JSONP requests
});
Property name Default value Description
EnableFeatures Feature.All Defines the formats which the webservice should understand
DebugMode false If true, stack traces will be shown in service responses during development
WriteErrorsToResponse true
DefaultContentType ContentType.Json
AllowJsonpRequests true
GlobalResponseHeaders Sets global headers which will be added to every request response. (Example)

Note: DebugMode should be set to false in production because of security reasons!

Logging

To ensure every ServiceStack service uses the same Global Logger, set it before you initialize ServiceStack's AppHost, e.g:

  LogManager.LogFactory = new DebugLogFactory(); 
  new AppHost().Init();
Something went wrong with that request. Please try again.